home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / include / linux / taskstats.h < prev    next >
C/C++ Source or Header  |  2008-10-24  |  7KB  |  211 lines
  1. /* taskstats.h - exporting per-task statistics
  2.  *
  3.  * Copyright (C) Shailabh Nagar, IBM Corp. 2006
  4.  *           (C) Balbir Singh,   IBM Corp. 2006
  5.  *           (C) Jay Lan,        SGI, 2006
  6.  *
  7.  * This program is free software; you can redistribute it and/or modify it
  8.  * under the terms of version 2.1 of the GNU Lesser General Public License
  9.  * as published by the Free Software Foundation.
  10.  *
  11.  * This program is distributed in the hope that it would be useful, but
  12.  * WITHOUT ANY WARRANTY; without even the implied warranty of
  13.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  14.  */
  15.  
  16. #ifndef _LINUX_TASKSTATS_H
  17. #define _LINUX_TASKSTATS_H
  18.  
  19. /* Format for per-task data returned to userland when
  20.  *    - a task exits
  21.  *    - listener requests stats for a task
  22.  *
  23.  * The struct is versioned. Newer versions should only add fields to
  24.  * the bottom of the struct to maintain backward compatibility.
  25.  *
  26.  *
  27.  * To add new fields
  28.  *    a) bump up TASKSTATS_VERSION
  29.  *    b) add comment indicating new version number at end of struct
  30.  *    c) add new fields after version comment; maintain 64-bit alignment
  31.  */
  32.  
  33.  
  34. #define TASKSTATS_VERSION    7
  35. #define TS_COMM_LEN        32    /* should be >= TASK_COMM_LEN
  36.                      * in linux/sched.h */
  37.  
  38. struct taskstats {
  39.  
  40.     /* The version number of this struct. This field is always set to
  41.      * TAKSTATS_VERSION, which is defined in <linux/taskstats.h>.
  42.      * Each time the struct is changed, the value should be incremented.
  43.      */
  44.     __u16    version;
  45.     __u32    ac_exitcode;        /* Exit status */
  46.  
  47.     /* The accounting flags of a task as defined in <linux/acct.h>
  48.      * Defined values are AFORK, ASU, ACOMPAT, ACORE, and AXSIG.
  49.      */
  50.     __u8    ac_flag;        /* Record flags */
  51.     __u8    ac_nice;        /* task_nice */
  52.  
  53.     /* Delay accounting fields start
  54.      *
  55.      * All values, until comment "Delay accounting fields end" are
  56.      * available only if delay accounting is enabled, even though the last
  57.      * few fields are not delays
  58.      *
  59.      * xxx_count is the number of delay values recorded
  60.      * xxx_delay_total is the corresponding cumulative delay in nanoseconds
  61.      *
  62.      * xxx_delay_total wraps around to zero on overflow
  63.      * xxx_count incremented regardless of overflow
  64.      */
  65.  
  66.     /* Delay waiting for cpu, while runnable
  67.      * count, delay_total NOT updated atomically
  68.      */
  69.     __u64    cpu_count __attribute__((aligned(8)));
  70.     __u64    cpu_delay_total;
  71.  
  72.     /* Following four fields atomically updated using task->delays->lock */
  73.  
  74.     /* Delay waiting for synchronous block I/O to complete
  75.      * does not account for delays in I/O submission
  76.      */
  77.     __u64    blkio_count;
  78.     __u64    blkio_delay_total;
  79.  
  80.     /* Delay waiting for page fault I/O (swap in only) */
  81.     __u64    swapin_count;
  82.     __u64    swapin_delay_total;
  83.  
  84.     /* cpu "wall-clock" running time
  85.      * On some architectures, value will adjust for cpu time stolen
  86.      * from the kernel in involuntary waits due to virtualization.
  87.      * Value is cumulative, in nanoseconds, without a corresponding count
  88.      * and wraps around to zero silently on overflow
  89.      */
  90.     __u64    cpu_run_real_total;
  91.  
  92.     /* cpu "virtual" running time
  93.      * Uses time intervals seen by the kernel i.e. no adjustment
  94.      * for kernel's involuntary waits due to virtualization.
  95.      * Value is cumulative, in nanoseconds, without a corresponding count
  96.      * and wraps around to zero silently on overflow
  97.      */
  98.     __u64    cpu_run_virtual_total;
  99.     /* Delay accounting fields end */
  100.     /* version 1 ends here */
  101.  
  102.     /* Basic Accounting Fields start */
  103.     char    ac_comm[TS_COMM_LEN];    /* Command name */
  104.     __u8    ac_sched __attribute__((aligned(8)));
  105.                     /* Scheduling discipline */
  106.     __u8    ac_pad[3];
  107.     __u32    ac_uid __attribute__((aligned(8)));
  108.                     /* User ID */
  109.     __u32    ac_gid;            /* Group ID */
  110.     __u32    ac_pid;            /* Process ID */
  111.     __u32    ac_ppid;        /* Parent process ID */
  112.     __u32    ac_btime;        /* Begin time [sec since 1970] */
  113.     __u64    ac_etime __attribute__((aligned(8)));
  114.                     /* Elapsed time [usec] */
  115.     __u64    ac_utime;        /* User CPU time [usec] */
  116.     __u64    ac_stime;        /* SYstem CPU time [usec] */
  117.     __u64    ac_minflt;        /* Minor Page Fault Count */
  118.     __u64    ac_majflt;        /* Major Page Fault Count */
  119.     /* Basic Accounting Fields end */
  120.  
  121.     /* Extended accounting fields start */
  122.     /* Accumulated RSS usage in duration of a task, in MBytes-usecs.
  123.      * The current rss usage is added to this counter every time
  124.      * a tick is charged to a task's system time. So, at the end we
  125.      * will have memory usage multiplied by system time. Thus an
  126.      * average usage per system time unit can be calculated.
  127.      */
  128.     __u64    coremem;        /* accumulated RSS usage in MB-usec */
  129.     /* Accumulated virtual memory usage in duration of a task.
  130.      * Same as acct_rss_mem1 above except that we keep track of VM usage.
  131.      */
  132.     __u64    virtmem;        /* accumulated VM  usage in MB-usec */
  133.  
  134.     /* High watermark of RSS and virtual memory usage in duration of
  135.      * a task, in KBytes.
  136.      */
  137.     __u64    hiwater_rss;        /* High-watermark of RSS usage, in KB */
  138.     __u64    hiwater_vm;        /* High-water VM usage, in KB */
  139.  
  140.     /* The following four fields are I/O statistics of a task. */
  141.     __u64    read_char;        /* bytes read */
  142.     __u64    write_char;        /* bytes written */
  143.     __u64    read_syscalls;        /* read syscalls */
  144.     __u64    write_syscalls;        /* write syscalls */
  145.     /* Extended accounting fields end */
  146.  
  147. #define TASKSTATS_HAS_IO_ACCOUNTING
  148.     /* Per-task storage I/O accounting starts */
  149.     __u64    read_bytes;        /* bytes of read I/O */
  150.     __u64    write_bytes;        /* bytes of write I/O */
  151.     __u64    cancelled_write_bytes;    /* bytes of cancelled write I/O */
  152.  
  153.     __u64  nvcsw;            /* voluntary_ctxt_switches */
  154.     __u64  nivcsw;            /* nonvoluntary_ctxt_switches */
  155.  
  156.     /* time accounting for SMT machines */
  157.     __u64    ac_utimescaled;        /* utime scaled on frequency etc */
  158.     __u64    ac_stimescaled;        /* stime scaled on frequency etc */
  159.     __u64    cpu_scaled_run_real_total; /* scaled cpu_run_real_total */
  160.  
  161.     /* Delay waiting for memory reclaim */
  162.     __u64    freepages_count;
  163.     __u64    freepages_delay_total;
  164. };
  165.  
  166.  
  167. /*
  168.  * Commands sent from userspace
  169.  * Not versioned. New commands should only be inserted at the enum's end
  170.  * prior to __TASKSTATS_CMD_MAX
  171.  */
  172.  
  173. enum {
  174.     TASKSTATS_CMD_UNSPEC = 0,    /* Reserved */
  175.     TASKSTATS_CMD_GET,        /* user->kernel request/get-response */
  176.     TASKSTATS_CMD_NEW,        /* kernel->user event */
  177.     __TASKSTATS_CMD_MAX,
  178. };
  179.  
  180. #define TASKSTATS_CMD_MAX (__TASKSTATS_CMD_MAX - 1)
  181.  
  182. enum {
  183.     TASKSTATS_TYPE_UNSPEC = 0,    /* Reserved */
  184.     TASKSTATS_TYPE_PID,        /* Process id */
  185.     TASKSTATS_TYPE_TGID,        /* Thread group id */
  186.     TASKSTATS_TYPE_STATS,        /* taskstats structure */
  187.     TASKSTATS_TYPE_AGGR_PID,    /* contains pid + stats */
  188.     TASKSTATS_TYPE_AGGR_TGID,    /* contains tgid + stats */
  189.     __TASKSTATS_TYPE_MAX,
  190. };
  191.  
  192. #define TASKSTATS_TYPE_MAX (__TASKSTATS_TYPE_MAX - 1)
  193.  
  194. enum {
  195.     TASKSTATS_CMD_ATTR_UNSPEC = 0,
  196.     TASKSTATS_CMD_ATTR_PID,
  197.     TASKSTATS_CMD_ATTR_TGID,
  198.     TASKSTATS_CMD_ATTR_REGISTER_CPUMASK,
  199.     TASKSTATS_CMD_ATTR_DEREGISTER_CPUMASK,
  200.     __TASKSTATS_CMD_ATTR_MAX,
  201. };
  202.  
  203. #define TASKSTATS_CMD_ATTR_MAX (__TASKSTATS_CMD_ATTR_MAX - 1)
  204.  
  205. /* NETLINK_GENERIC related info */
  206.  
  207. #define TASKSTATS_GENL_NAME    "TASKSTATS"
  208. #define TASKSTATS_GENL_VERSION    0x1
  209.  
  210. #endif /* _LINUX_TASKSTATS_H */
  211.